Functions
IMPORTGOBI ULONG GOBICMAPI	SetDeviceRemovalCallback (tFNDeviceRemoval pCallback)

IMPORTGOBI ULONG GOBICMAPI	GetImageStoreA (WORD pathSize, CHAR *pImageStorePath)

IMPORTGOBI ULONG GOBICMAPI	GetImageInfoA (CHAR pPath, ULONG pFirmwareID, ULONG pTechnology, ULONG pCarrier, ULONG pRegion, ULONG pGPSCapability)

IMPORTGOBI ULONG GOBICMAPI	GetImageInfoW (WCHAR pPath, ULONG pFirmwareID, ULONG pTechnology, ULONG pCarrier, ULONG pRegion, ULONG pGPSCapability)

IMPORTGOBI ULONG GOBICMAPI	UpgradeFirmware2kA (CHAR *pDestinationPath)

IMPORTGOBI ULONG GOBICMAPI	UpgradeFirmware2kW (WCHAR *pDestinationPath)

IMPORTGOBI ULONG GOBICMAPI	GetImageStoreW (WORD pathSize, WCHAR *pImageStorePath)

IMPORTGOBI ULONG GOBICMAPI	UpgradeFirmwareA (CHAR pSourcePath, CHAR pDestinationPath)

IMPORTGOBI ULONG GOBICMAPI	UpgradeFirmwareW (WCHAR pSourcePath, WCHAR pDestinationPath)

IMPORTGOBI ULONG GOBICMAPI	GetFirmwareIDA (CHAR pPath, ULONG pFirmwareID)

IMPORTGOBI ULONG GOBICMAPI	GetFirmwareIDW (WCHAR pPath, ULONG pFirmwareID)

Detailed Description

Function Documentation

IMPORTGOBI ULONG GOBICMAPI GetFirmwareIDA	(	CHAR *	pPath,
		ULONG *	pFirmwareID
	)

Returns the ID for the firmware located at the path provided as input (ANSI variant)

Parameters

pPath	[ I ] - Location of the firmware
pFirmwareID	[ O ] - Firmware ID obtained from the PRI image

Returns: See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetFirmwareIDW	(	WCHAR *	pPath,
		ULONG *	pFirmwareID
	)

Returns the ID for the firmware located at the path provided as input (UNICODE variant)

Parameters

pPath	[ I ] - Location of the firmware
pFirmwareID	[ O ] - Firmware ID obtained from the PRI image

Returns: See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetImageInfoA	(	CHAR *	pPath,
		ULONG *	pFirmwareID,
		ULONG *	pTechnology,
		ULONG *	pCarrier,
		ULONG *	pRegion,
		ULONG *	pGPSCapability
	)

Returns image information obtained from the firmware located at the provided path (ANSI variant)

Parameters

pPath	[ I ] - Location of the firmware
pFirmwareID	[ O ] - Firmware ID obtained from the PRI image
pTechnology	[ O ] - Technology (0xFFFFFFFF if unknown)
pCarrier	[ O ] - Carrier (0xFFFFFFFF if unknown)
pRegion	[ O ] - Region (0xFFFFFFFF if unknown)
pGPSCapability	[ O ] - GPS capability (0xFFFFFFFF if unknown)

Returns: See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetImageInfoW	(	WCHAR *	pPath,
		ULONG *	pFirmwareID,
		ULONG *	pTechnology,
		ULONG *	pCarrier,
		ULONG *	pRegion,
		ULONG *	pGPSCapability
	)

Returns image information obtained from the firmware located at the provided path (UNICODE variant)

Parameters

pPath	[ I ] - Location of the firmware
pFirmwareID	[ O ] - Firmware ID obtained from the PRI image
pTechnology	[ O ] - Technology (0xFFFFFFFF if unknown)
pCarrier	[ O ] - Carrier (0xFFFFFFFF if unknown)
pRegion	[ O ] - Region (0xFFFFFFFF if unknown)
pGPSCapability	[ O ] - GPS capability (0xFFFFFFFF if unknown)

Returns: See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetImageStoreA	(	WORD	pathSize,
		CHAR *	pImageStorePath
	)

Returns the image store folder, i.e., the folder containing one or more carrier-specific image subfolders compatible with the currently connected Gobi device (ANSI variant)

Parameters

pathSize	[ I ] - Maximum number of characters (including NULL terminator) that can be copied to the image store path array
pImageStorePath	[ O ] - The path to the image store

Returns: See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI GetImageStoreW	(	WORD	pathSize,
		WCHAR *	pImageStorePath
	)

Returns the image store folder, i.e., the folder containing one or more carrier-specific image subfolders compatible with the currently connected Gobi device (UNICODE variant)

Parameters

pathSize	[ I ] - Maximum number of characters (including NULL terminator) that can be copied to the image store path array
pImageStorePath	[ O ] - The path to the image store

Returns: See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI SetDeviceRemovalCallback ( tFNDeviceRemoval pCallback )

This function enables/disables the device removal callback

Parameters

pCallback [ I ] - Callback function

Returns: See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI UpgradeFirmware2kA ( CHAR * pDestinationPath )

This function performs the following set of steps: a) Verifies arguments b) Updates images preference on device c) Resets the device (ANSI variant)

NOTE: Upon successful completion the above steps will have been completed, however the actual upgrade of the firmware will necessarily then follow.

Parameters

pDestinationPath [ I ] - The fully qualified path to desired firmware

Returns: See GobiErrorCodes.h

This function performs the following set of steps: a) Verifies arguments b) Updates images preference on device c) Resets the device (ANSI variant)

 NOTE: Upon successful completion the above steps will have been completed, 
 however the actual upgrade of the firmware will necessarily then 
 follow.

Parameters

pDestinationPath [ I ] - The fully qualified path to desired firmware

Returns: See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI UpgradeFirmware2kW ( WCHAR * pDestinationPath )

This function performs the following set of steps: a) Verifies arguments b) Updates images preference on device c) Resets the device (UNICODE variant)

NOTE: Upon successful completion the above steps will have been completed, however the actual upgrade of the firmware will necessarily then follow.

Parameters

pDestinationPath [ I ] - The fully qualified path to desired firmware

Returns: See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI UpgradeFirmwareA	(	CHAR *	pSourcePath,
		CHAR *	pDestinationPath
	)

UpgradeFirmwareA (Deprecated)

This function performs the following set of steps: a) Verifies arguments b) Updates images preference on device c) Resets the device (ANSI variant) NOTE: Upon successful completion the above steps will have been completed, however the actual upgrade of the firmware will necessarily then follow.

Parameters

pSourcePath	[ I ] - No longer used
pDestinationPath	[ O ] - The fully qualified path to desired firmware

Returns: See GobiErrorCodes.h

IMPORTGOBI ULONG GOBICMAPI UpgradeFirmwareW	(	WCHAR *	pSourcePath,
		WCHAR *	pDestinationPath
	)

UpgradeFirmwareW (Deprecated)

DESCRIPTION: This function performs the following set of steps: a) Verifies arguments b) Updates images preference on device c) Resets the device (UNICODE variant)

NOTE: Upon successful completion the above steps will have been completed, however the actual upgrade of the firmware will necessarily then follow.

Parameters

pSourcePath	[ I ] - No longer used
pDestinationPath	[ I ] - The fully qualified path to desired firmware

Returns: See GobiErrorCodes.h

Functions

Detailed Description

Function Documentation